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n«s is nn introduc{ory manual describing the display 
available .on the Stanford A. I. Laboratory Pl>5> 10 com 
intended to be used as an aid for the beginner as well as 
who either are unfamiliar with the I- editor or use it infn 
the iwoLon-linc manuals that help the beginner to get star 
description of tile editor for the experienced user. 

,E i$ commonly used for writing computer programs'; 
memoranda. It is not a document editor, although i; ^ VJ 
ECttmg.a document into a pleasing format. -The primary emphasis 

in terms of the number of key srrninW riViiiirA/I «»r iltA J •_ 

made on the computer system, 
range of facilities,. 4hat 


computer: programs and ior preparing reports and 
nent editor, although it docs provide some facilities for 

; is that of speed, belli 
aroaes required of the user and in terms, of the demands 
At the same time. H is easy to learn and it offers a !arr>.» 
srs not available on many • editors. .. -■ .■ 
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nWnt "??"*! 31 is acondcnShtion of the on-line n.Arsiur.Doq manual and it is not a substitute f< 
complete documentation .therein presented. The aim is to provide the user with a hard 
manual that tells him what can be done by E and where he can * ' ' 
in the on-line, mangal. ‘ ; . - 

So many people have, by now. contributed to this editor that it 
Dan Swinchart. wrote- the original TV editor and created the 


is difficult to- ascribe prop 
£ w,ncnat ?; wrotc inc original I V editor and created the original version of trrtvtci! 

Fm^ h Mi^ 0rkCd extcns,vc| y on .H mclude Fred Wright, Brian Harvey. Arthur Samuel an 
( Frost. ; lne present manual was written by Arthur Samuel. 

Special Symbols 

Special symbols are used in this manual (also in n.Ali 

The arrow UNF. refes to one l&c of text that 
presence, of an arrow 'to the left of this line, and 
beneath the first character. . „ 

flic Cl-RSOH refers to the underscore under 
mo dc. ,On the DataMedia terminals this' c 
arrow line by the fact that the entire !i 

The keys labeled "CO VI Rot " on the DntnDi 


row line when in the line-edit 
rom the cursor pointing to the 
i in the line-edit mode. 

on the DataMedia tennina! are 

not to confuse them. 

. - • On the DataDisc^ • 

a means hold'thc CONTROL key down while typing the next character. 

/? means hold the mkta key down \vhilc typing the next.charnctcr. 

crp means hold both the COM ROI and the Min . \ keys down while typing 

© -means hold, cither the CONTROL key or.both CONTROL and MITA keys with the next character' 

On the DataMedia 

a means hold the EDIT key down while typing the next character. 

key mcans lnakc ancxtra ke - v strokc ahead 'of the character holding EDIT key and typing the null 

o/J means make an extra key strokc ahead of the ..character, holding edit key and typing the \un 

key; then keep the l-Dir key down' while typing the next character cy typm S ttlc NUU ' 

® means do either as explained for a or . as. explained for a(i (but not as for 0). 

. S ". mc ° f .^ c characters -on. the DacaDftc keyboard arc missing from the DataMedia and rcouire the 
RE- key. See the Appendix for full details. 

’ Hold and Type then . Hold and Type ^ 

<e!i!t> <M 't> (for a typical available-key. represented by A) 

<i:i3t i > * <nu > <i-i)i p A . 

<EOi l> <cu> " (for a typical special key. represented by <CK>) 

<M)ir> <NLI.> <CR> 

<i'»H > <NL I > / <1 l)||> < C 'R> 8 

DkClRO K ‘ ’ (for a typical missing key e) 

<M>n> <\f.r> «-i ki> |-' 

‘tfi* <!-mr> <m i > <: diixciro f 


aA 

M . 

aft A 
,<CK> 

«<do 

/?<CR> 
,a/?<C R> 





1. Introduction ^ 


F iso diSplay-oricntcd text editor avnilab!c-on the Stan for 
not a document editor, although it does provide some 
pleasing format. It is regularly used by many people for 
of the texts. that arc subsequently used as ' 
emphasis, is that of speed, both in terms i 
terms ot the demands made on the comp 
offers a large range of facilities that are n 
version copies anr not made unless the user spot 

"Hiis is an introductory manuai. intended to be usci 
experienced computer, users who either are unfamiliar 
manual is not intended as a replacement for the on-l’in 
of the capabilities of the [• editor that can' be used 
specific tasks. In the interests of simplicity, most oft! 


a a.i. laboratory rDr-10 computer. It is 
facilities for getting a document into a 
writing programs and for the preparation 
inputs to more, elaborate document editors.- The primary 


I wo on-line F. documents arc available. 

ni-ACIt is an teachi"; ~ J - 1 

initial information -needed is that of how ti 
tjpes Ill-.LP 1- ri-AC! I followed by a carriage 
step. Hven the experienced c 

ddie second on-line document, 
typing in?<CR> to the system 
l-rcquent references will I 
■°n P :, Sc\ I and the index of nil commahds 
useful in locating additional information 

2. Bnsic Features ■ 


! U .!h C ?. tl ?- C 6csinncr - stcp bv stc P. into the tisc of F. Hie. only 

lining logged on. the user sirnply 
n then instructs the user, step; by 
brief session with this, program. 

F-..A1 S[LP.IX)C1. is an all-inclusive K manual. It can be referenced bv 
.. . .or hy-vpms <CONTROI* if currently editing some either file. 
T r Tn d . C -^’._ t .H S ,° n ' ' UC ' 11imuaI ln . thc Pre'sem publication. Hie directory 
on P n S° 3 of this on-line document, will' be found most 


restricted to some logically related sub-section Of the 
page size to that desired for the finished document a 
o.nc to break pages into smaller pages and' to combine 
also possible to tyring several contiguous pages into co 
best- if the si/e of the individual pages is limited- to p 
■quite capable ol handling very large pages indeed, hi 
and ol the. load on 'die system. 

Normally; only a single page is kept in core while it is 
copied onto the disk unless requested or until one. mo 
greatly decreases the demands on the system. It allow 
ttyc page being edited bv .Y single command, if'desira 
page of recent corrections can he lost if the system -i 
s;i\c command or has dime so indirect Iv In going to ai 





Section 2: l)n.sic.Fcniiiic* 


?i 


. . . C< %. . - 

K. Because of paging, there is no practical limit to die si/e'of the files that can be edited hv t'- 
other than the limit imposed by the computer systems itself. . • ' " .»•*. 

V hetween d n * pCC ^! f f '! ic 5 ( <,l " movin 8 from, page to page within any one file' aiid for moving ’ 
between hies, wth the Mtlormaiion as to the recently visited, files, including the page and -J nc " 

- w:’o„ CPt an '"‘S™ 1 «** *’ »’ a ‘ <>ne can return to.these locations®* ,h s mbih un ?,f 

zrzfsrr “ yr,ic *«= * <• » *> • 

2.2 File Formatting 

■ ih-.?!w« S n! hC f fi,C ' "’ m ' S , hcing cdited ,0 Re formatted internally' in a particular way Please note 

> • • ‘ • ^ •• ‘ • ( 

PVnnat.cd files .have a special first page that is created by . [• arid automatically kept ttp io d tte as 

. ^finSK TZ'Z'Z IT™'. ** ” f "> 

2.3 . The Window' s 

' SSrf CarliCr ' t, . is P ,a >- oricntcd editor. Since the screen si/e will not usually permit 

< f e nt, re page ol text. 1-. exhibits the text that is being edited as if throu-h i window 
One' Im u T^i" 1 '! nslc ; d, ‘ ir:ict f ^ commands that move this, window around on a page of the text' 

•• °, ' ‘."' C u l W 110 u "’ d r- lhc AI<R0W I.IXI-:. is marked, With an arrow to its left More - 

' Whc " Cjiting • rk -’ RS0R -.1 underline one 

kself n .lvu , ,i,' h t h!? r ; |' pl,U ; d0S cc u rlail ’ biIS of information on the screen, in.addition 'to the text ' - 
. ttsJf. that till the user something about the file that Is being editing and the state of the edit na 

S some text III the- indicated direction that is in core hut that' does not show in, the window. 

I he header line also contains the following: 

' lie nllmllertcl” r-°i lCX -‘ UnC Ih; “ i,ppcars jl,st bc!,m ,hc heavier ■- line. : 

*• • ' mini I h its) i'l the • m-cofc p;ige(s). • 

3 l hc;' name of. the file being edited. 

4 Some- information - as io the editing mode (to be explained later). . 1 ' 

I he trailer, line also contains - ’ * 


■ . .v , 

T’kPT;^ j 

:■ ’■ ";4| ftv j 

. ■ 

- . 


■ ■ 

. ■ • ■ 

M 


■ 

: 

■ 


1,10 nill '' ,5 er of the current-’ line (at the arrow) that will he entered if. 


otic starts’to type 


•• 

g# . ‘ A ; - r 

■ % 

; . 

■Xi •• • 

, 

■ 

i-': - 


BK 






Section 8: Text Fomialting Commands 



Section 2 : Basic Features 


number of lines on the current page.! 9 . ■ 

cr of tile current ' page. * 

number. of pages in the file being edited. 

nation about the size of the page in core (do Sit et? for more details). 

nyling line there is a region below' it where typed-in information is echoed and 
f information arg typed out. either to inform die user of the status of his editing 
m questions that he can ask. for example, the message "Rippling" may appear 
h is readjusting die disk assignment of your file in response to an increase Ir 
1 wo commands (®XrrRSir<CR> and ®Xvi:rhosi:<cr>) enable the user to cithe- 
he amount of information that H provide. There rtay also be two fines of 
tHe heading line (the who lines) that contain system information. 


rita arguments are frequently used with certain commands. Are, intents, 
kevx y the symbol # or by a typical numerical example. When tl 
keys are indicated, these, keys must be held down for all digits', 

will hp'rof ° thCr | k< K S T U ’ C ° atanisc keyboard that are- used for spe 
. ' bc re fei ciiccd by their, names in angle brackets, such as- a OR.\t> 

, . 'I 9 ca ™ ;, 2 e r emm kbv (marked <RI-ri LRN> on the DataDisc and D'ataV 
ted in this manual as <CR>) also is used for several special purposes is 

Qi’ >% ind C Mi ?\ lK ' 1 ! 1 d<m '’;' vhilc s,r ; ki »P "Iher keys although they mm 
Ql and Ml iA keys. See Appendix A for; the corresponding keys ', 

lo Start an Tabling Session Using K - * 

t an editing session using I- one types 1:1-1 oo«j«> where t oo is the n urn 
CrCi !‘ C ;, . nc . w fi,c lu,,K ' d 1 00.. the system command is n r i oo< 
- hC l<I An WI<l " ,nodc t,r •' Ri AivoMV nu.de. One 
Ihe /« ,1V T'l’ing /R between the end 01 

"V 1 *. ,s ,.! 1 ;l s ' VIIch - 1,1 which there arc several, as will he cvphine, 
ode should always bc used if', me wishes to read a file h,„ ,,, ,1.. 
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Section 2; Basic F 


Stores 


•’"• - •' 


• - Hss wssr* * 

2.6 .E Commands •• ' ' •; . 

|^P=£SHSSS= 

* •» "*■ <» 

@X'(for extend) followed by enough let cS Mm Z nil C T. rnands a11 <**" with 
the' 'command. If not enoueh letters are v a ^ C * wlthout s P cclaI keys) to disambiguate 

command. «X • •*»* 

' some other activating character Thev „Oon 11 r ° rClt * ra " uC!!> or ln - a few special cases by 
name, and the temfinatiom * * for e^tra parameters, to be typed between the 

command. In Lncmf'Thcn on^'dTscovmlhal'oneTs tynin^ thT ° f ’ at? h ° rtins . any P :i «'a!ly-typed 
easier to type <alt> than to try- some other mens r yp ‘ S . thc , wron S thing, it is usually safer and 
abort any partially typed 6?X*0omnrmd- met , tn correcting the error. In particular. <AL'D will: 

insert mode (to be P discribcd later) to its nrevinMc el^m.''"'. 7 bci " 8 edit S d in thc linimojit or 
substitute command being typed. P '° US contcnts: terminate* and abort any search or 

b . i 

b.” y I, m“tS “3 mfcdmc" St ! riT" 1 - “ »' **i- 

= , mode of operation mop be. inform,,™ * ^ ?£?£ *£ {£&&; 
2.7. Editing Modes / ; 

defa Jl^wud^lh'u ^E en ic rs b ! n i da | ly* ft caNedThfxoRM N^rn'Id'- ‘T * distinct modcs -' '>'•= 
one enters most of the other modes M™ „r , a ? nd 1)1,5 ,s thc modc which 
modes will be described later For thc moment . cnmrTMnds that ' mn V ;bc used in thc different 
different modes, since mmc comi" „ds hC o.dm “ ” por “' “ r «”8"“ the essence of tec 

■ic,r„ . re, r 

2.7.1 Thc NORM At. Mode e ' ’. ' ' ' 

s,™™ satr % isrsairri *7, « «» «*«> " 

. required. ,„d oil, reinrn L J w ST**,* «*» «• 
T“ f?> .T e,;,nmn„ds rSlic iS^£ZS£££ *J*”- 

# ss z sssi,^s • 




e: ‘:V , 

V e'e,. . 


|Ri 



Sectica 2: Basil 


DataMedia, the arrow 
the line. 


LINE is identified by an underscore or CURSOR under the first character of 


M>me special normal mode commands should be learned 

©4<cr> Move the arrow down- 4 lines (but 
a<CR> No action when in this mode but used 
/3<cft> Introduce an empty line : ahead of the 
a) 5<CR> Fntcr the line- 


at tiiis time: ^ • 

not beyond the trailer line). ' . 

to return to it from other modes. 
arrow line. 

•INSERT mode (sec below) and introduce an empty line as the arro 

H, n p"! Cr t j! c , INC - EDrr mode and overwrite the first character in die arrow line wit) 

tn p"“ r UNE ? D,T modc and dcictc thc first 3 .characters' in the arrow 

v , r ' , Drr modc and inscrt thc character "D" ahead of the first ci 
©oa/?D Delete 6 lines starting with the ARROW-ijne 1 

2.1.2 The t LINE- shir Mode 

This mode 


r , ls usc d for making deletions, corrections and add; 

rrom the, NORMAL mode simply by starting to type, using .in 
without any of tlici special control keys' that are used to id 
commands that arc used to move around 1 within a line of text 
non mode, as will be .explained later, i 

While in this .mode, any typing that is done will appear ir 
(underscore) will appear under the character position where thc 

' l ^ rr Mcdla ; thCARROW , INI : w j,, appcar brjghter than 

the I IM-.-EDIT mode (where the cursor is used as just discrib 
the CURSOR is used to indicate the arrow LINE). 

TTic carriage return key «CR» is normally used to terminate tl 
the normal mode With the arrow moved to thc- next line 
when thc CURSOR is not at thc end of the line hem„ 


.Mi-LDiT mode and to return to, 
v.il! perform this function .even’ 
line will be written into the in- 
i thc screen. To insert a carriage Return into tiie line at 
r mode) one must use the /?<cr> command, as will be' 



Scctiss i Basic Features 


rctum. iviihom control Secy, docs not terminate 
to lx; inserted into the text. ITiis mode is usually tc: 
differs from the UNE-insert mode (to be dise/ibed 
rt^torc "the line to'its original condition (but only bad 
while in the insert mode). 

2.14 The UNE-INSERT Mode 

This mode is used when one wishes to insert one or r 
entered from the normai and insert modes by tv 
everything that is typed (including carriage return: 
distinguished by the presence of the letter ’T in the i 
nr placc’pf-a single arrpw in front of the arrow line 
:lhc «<CR> command, if given at the beginning of a nc 
the text. while the <ai.t> command wilj-abort the emp 
text, as it docs, in’ the insert mode). 

2.7.5 The attach mode 

While in this mode, a selc 
special aitacii buffer in 
moved to another file, by 
timev the text in. the ait 


the text is removed . from the in-core text and is. held 
n it can be moved around within the opened die' or e 
e commands that are used in the normai. mode.' At 
the first few and . last few lines... if die selection is. lor 
reen at the position in the in-core’ text where it will 
' command be given. This mode is distinguished by 
line and by vertical bars, to the left of the attached I 
commands . lor .entering and leaving this mode, will 






Ssrttea 3: A Typical Kdltir.g Session 


'K, a session with HELP ETEACU is recommended. . If you have had 
k or some other editor, the -following bri# summary of a typfcd 
References are given for locations where flic detailed discriptfon of 
commands) may be found. • , - . . 

’ file named newiii.r. (section 2.5 page 5 ) ' 

in read-only mode.' (section 4.2 page li) 

JaimeA (section 4.1- page"’. 10)- 

assume that this places the 
you .want to copy, . (section 4.1.3 page • 10) 


Ni.wnuxcR> .nus opens a new 
©Aoi.Dni.ixcto Entering this file i 

©P -.This command-. might be repeated several t ‘ ' ' 7 " 

^ORM) 1 Ills brings in another windowful. (section 4.T.2 pane 10) 

©> . Move the arrow down to the middle of the window. We will 

arrow at a line ig£& paragraph that j— • - 

afiM So mark this line, ^section, 4,3 page 11) 
oH Now back to. NEWFiut (section .4.2 page 11) - ‘ 

J™/ r ' n , 0 *. ,yP i nB . ,mo NEWr,U: «» l-INE-norr mode, and this Hnc of .will „ppcar cxac.lv os here IVDcd ' 

^ROW ar u, a8 thf t nex| U lfnp yOU h ty ' PC bn08S y0U back t0 *C -NORMAL MODE and moves the 
’tZZ l ,WherC y ° U ™ y ConIinuc ty P in S < scc£ ion 5.3 page 13) 

p bnC . r [°° k - at ,:A1 - S ' L ' Pnoc l m '2l>t help at this point, (section 4.2 pa-re 11) 

sraMi rssr ts r^r in ” ,,pins ^ < x 

^ o mpty ,.„ y in( o 0,0 t e< t 

T. “s-s “ 6 r ss? s d sr.sr ^ «* ** » : 

apM Mark the line, (section 4.3 page 11} - 0 

®-® P S 01 " 8 * Pa8C ma " C S °™ C corrcct;: ° ns - The second page will be saved 

® ^“1: .5*™. ,htf ARROW ,0 the- .end of me page, (section- 4.LJ page 10) - 

ofiWM naC h “ P t0 Ul ° f ° Urth linC ° f ,m from £hc (section 4.113 page’ 10) 

SSSfVrW ■n,"".' nd ° f ** ™ S »«' Olo-UNMDir 2o. 

^ c, ' ,rsor and deletes the last character. You can back up as much 

ol ^r, th T S r‘ n v P ' n8, CndmS alwayS with a <CR> - (section 5.1 page 12) 
Nowback. to the first iine on this page, (section 4:1,3 page 10) ' 

a/32o/?D Th,s deletes the first \two lines on the page! (section 9.1 page 21) 

„ Hi's - ends the . session, (section 2.8 page 8) ” 

To Resume Editing You Forgot. Something. 

! S S l!l^^^! , . n ! a J , . d ; is sivcn immediately after the ©H command everythin* 


Sortie 9i Seine AtMsfiennl 



Session 4: IvSQvfcg Arcand 


4.‘Movin'g Around .(wbi!i 


Some of the more important commands for moving within a single- fill 
listed here. For a complete list of these commands * see (’.ai.SH 

'4.1- , Moving within a.. Given Fiie , 

4.1. 1 Moving from page to page (after writing out the current 

Go . to,; the next page (note that ® + ©1 is implied). 
'Go to page number; 6: ■ . 

Go back a page. " . ■ ’ 

Go to the previously viewed (Old) page as lis 
Go to die second-prcviously viewed page as listed 
this command dan be changed by the user. I 
Go to the #th previous referenced | _ ' 

Type out the, page '-staple (at the bottom of the 
referenced pages, so iluu 


©p - 

©6®P 
-®-©P 
dO • 
a/iO 


;tcc in the page- stack'. ' , • 
in the page stack. The meaning of 
For details see I-.AI.S. 
page in the page -,stack. 

screen) listing the more recently- 

one may' return to them directly, 

4 . 1.2 . Window-moving commands (moving' the ARROW, if necessary) / 

Move forward- one windowful but do- not cross .a’ page boundary. 

Move backward, one wjndovyfui but do not cross a page boundary. 

Move’ forward one windowful even if this means writing 'out die page and crossing a 
page boundary.' • .'< 

®<Vn> Move backward one window*, 1 even if this means writing out the- page and crossing a 
page boundary. , - . ' 

®J' Jump the window so that,- the "ah now i ini- is. at the 'top of the screen ' 

®0®J- • Jump the window to put the the arrow T.ini: j,1 the middle o'f the screen 


®#aO 

®OaO 


a OR.M> 

<vp 

®<roR\t> 


• ARROW-moving -commands (moving the window, if necessary) 
Move the 


down a line. y k . 
up a line. 

down 4 line's. . ' ' > . 

up 4 lines. 

down 1/2 screen. , „ 

up 1 /?- screen. - . . ..« 

to the jop line in the window’: 
to the bottom line in the’ window. . • r ' 
to the first line of the current page. 

Move the arrow to the first line of the iivcore text (there nuv be more 
Movfc the arrow to the it th line of the page. Note that the line number 
on the text and they .jre-not avoided! -but F keeps track of them during tli 
so th.it. they may he referenced.' 1 '.>• 


/ Section 9 : Some Additions! Cen&tr. 



Section 4: Moving Around 


afiN 


" “* s “‘- n * »» « 

•n>°c V< ml!lni^ RRO r VV thC Second P« v '««sly referenced' line as listed in the line stack 
N m 7 ° f C ^ nB “ nd Can bc cha "3«» by the user. For details see .'S’ 
®l aN Move tlKt arrow to the tfth previous line in the line ' stack - / . ' 

•00©|M . Type the line stack (at the bottom . of t],e screen). ^ 

• 4.2 Mdrlajj, to Other Files ; : ... •• . 

««wk • 

™ m«* ->«*■» «*■>«• K , i 8 ^ ,, ti c s n t:si,r^ 

' S? "" "" «?* — •» "="’> created rile tamed s,,ve. - 

* can be chanS* ^ Thcmodc ' 

'“?pSS=2^~3SE S5S 
■S3^|S3S~SSS-£= 

Rethrn (Home) to the. Hast referenced file at the page and line last referenced' - ' 
%#all Go to //th previous .referenced- file as listed in the' file- stack - 


®?/ 

■ 

ap\\ 


Aids in Moving \ A round • , " * 


• !^ 0rdil, S 'bevpage number and the line mm, her. 


a PM 

«M Go to.tlK next mark (cyclically). 

®-«M Go to the previous m.,rk (cyclically). • 

® #nM Go to the » th mark forward (cyclically)/ ; . 
®X/MARK<r;R> ’ /.erj> (clear) the marks in the current file 

. , •' 




' S. Editing Liraes 'of Test in thsl -LINE-KD3T Msitel •• 

. . ■ •••”-■' ' . 7 • .. ’ ■ • 

• cariicr. deletions, corrections and additions t/lincs of teat can be made using the 

UNC-rn r mode. While in this mode, any normal, typing ‘that is done mil appear Sr the ARROW um 
ana will overwrite characters that are in positions marked by the cursor: Jt may fee worth 
. repeating at this point that the uni: editor wjll only handle lines that contain 4ss than 133 
. characters, so the user must terminal? lines as they are being typed by using the <cr> kejl 

'• U” ‘ j NE -E. D, T mode is entered from the normal mode cither-' by typing any normal printing 

■V' charac «r (including the spacebar and the tab key), or by typing any one of-the special LINE-EDIT 
commands g'Mcn below except for those marked (will not enter). Commands that are so designated 
have a different meaning in the normal mode from their meaning in Lhe LlNE.TDif mode and so 

- can " ot bc used to enter. It should also be noted- that the LlNL-cnrr mode cannot be entered while, 

m'tne ATTACH mode. f A limited number of normal mode conimahds may! However be given 

- .while in the liNe-kdit mode. - • ■ ■ . . • 

I? (sr . " ' . . ' ‘ 

5.1 Moving the cursor • . 

'■i ■ ; ' . . - _ 

V o<SPAC'f> Move the cursor to -the right 1 character. 

cr4<KSPACE> Move the CURSOR to the fight 4 characters. „ 

,<bs> Move the cursor tO the left 1 rhnrnrfor Hr»Ir»rinr» : rr i . /• .. 


a<TORM>. Move the. CURSOR to the "start- of the line, (will -not enter) ' 

i*S tfe/Kchar) . Move the cursor’ (Skip) to the next occurrence of. <char> . 

oJoS //ir/i.<char> Move the CURSOR (Skip) to the 3rd next occurrence of' <char> 

’* B ,hen <char>, MOvc the CURSOR Backward to the nearest occurrence of <char> (will not 
• • enter ) . -j • . - 

c6gB Mf " < char > Move the CURSOR Backward' to the 6th nearest occurrence of <cbar> (will not 
en ter) - * 

“ R ' Repeat the last «S, aK, cB or^L command (saves retyping- die <char>). 

S.2 Inserting of i Deleting Characters ' . 

r , - . ' 

P <ch ar> Make . room and insert <ehar> ahead of the character that is in the CURSOR position. 

cD Delete the character at the cursor nncirinn mru/r* t!vn root of « i _ 


<»4'aD 
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Section 5: Editing Lines .of Text 


•* • .' enter) ... ■• ,i >. " - /'■■ '■;/ 

eR Repeat .the -list eS, oK ai! or oL command (saves retyping . the <char» 

a '• * rranspose the order of tl>fc two characters just to the left of the cursor (to correct a 

- . ■ - common typing .error)/' (will n6t enter ) ' us <' to correct a 

5J leaving- the une-edit Mode ‘ •" N . 

fjtcre are, MVera 1 'c(raiiiands*br returning- to the normal- inode. Thcsc.-nwy be given with the 

wXed* atKdnf ther" th f , ' nc .? nd .. whcn ' so 8iyen a -carriage return (actually a edtltoMU 
into P me d in v ■ ■ • thCj)u ' c; lf hc llnc 1S not a| rcady so terminated., and the line will be written - 
-.into the inreord- copy exactly as it. appears on the -screen . . * • 

<CRy j Accept the line, lpavc line-edit mode and move „ die' arrow to- the next line 

c<CR> Accept the line, leave lint-edit iriodc but do not move the ARROW 

. ,w I r . n CCCpt thc linC ’ ' Cavc thc IJNK:, ® rr mode and. move the arrow -yp one line:" 

estorc. the line to its original condition and leave, the UNF-fjmt -cncdc. 

Oneway also -leave the UNE-edit modtr'and. enter either the INSERT mode oruhc^E-iNSERT 

■ ••'./ Enter the insert modir(like holding <-meta>. continuously). When in the insert' 
... .- •• . modc ’. any 'JNE-edit- cqmmand -will return to' the i.rNH-EDir mode. ’ " 

aP<at> ' 5 n r ? k i 11 ® Iinc p at *c. CURSOR and enter thc i.ine insert modc with thc CURSOR at the 
• cn ^ of the first segment of the original line ^ 

Entcr to* LiNE-lNSERT. mocfc. at Un-end o( 'the previous "fine . 
aP * Krftcr the .LINE-INSERT mode at thc end of. the following line. ' . '' 


5.4 " Move to Another Line, still in the link-edit Mode. 

i S? a “ 

•at , Move to thc end of the previous line. 

ul Move the thc-Cnd of the following line. 

a/?: •"'ft th' c • present column position as t^COi.UMN ot^ interest and move 'to 'this column 
in the- previous line (if possible, otherwise ' to . tha.remjr'of the line). • 

Move to the dDl UMN OF INTEREST (as -earlier defined) in. thc previous line (if oossibleV 
without regard for the current column position. >ous line (it possible). 

in C 'Z tl ' c n prcscnt , coUlr V position ^ tile COIUMN OE- INTEREST sand move w this column 
in . the following line (if possible, otherwise tb the end ofAfre line) • A 

COLUMN. OE INTEREST (as earlier defined) in the following line (if . 
possible), without regard lor the .current column position 

Duplicating a Line ’ ; v : . 

Make a copy of the line just above the arrow. line and enter the i.ine-eeht mode in this 

- ssrsit ” r '" ir ” "A ■ * ““ 


... • AT. y 

■» 
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Section 6: Attaching and Copyist 


6. Attaching and • Copying tines of. Text 


The Attach command removes- the lines of text from the. core imdgc of the nacc and n l™ 

«" mc’^'Sr m ol")he r a ,argC por T:°r tm f ™' ("SC to page. ahd particularly from 
,, is safer to Use the Copy command and then subsequently delete the original record ' 

they. 'omJeT be* Uwt : il‘'^Jp , *s>Tacin- , ^w’^ T.Kitoo^ld'miri^^ 

. •' tlwt- the disk . assignments be altered. ■ , ' *. 

6.1 Basic Commands . t a' . , * 

®A Attach the arrow i.int. .(removing it . fr.ifn the in-core text). 

:y . . m .‘'i Ch thC C l’ Py of thc . ARk ? w 1 lx Ci If this command is given when there is-' 

■ rccoplcd ""t n t ! e - ;llU,ch hul1er - thcn tho ciuirc attachment will be deposited amt 
' ^qrthm of teM. P “ W to. make., multiple copies .of any dc/red 

Attach 4 ■ lines starting with the arrow i ink. ’ " 

Copy- and attach .the copy of 2 lines starting with the .'arrow unf 
Attach the current paragraph. See Section' 8.6 for more details.’ ' 

' ffiih S T‘ X ! hC c . MITCnl - Panigiiiph starting with, the arrow i ini:/ ‘ 
ral' . !T M !h ' on the screen and 


®4®A 
®2®C 
51® A . 
n/fl® A 
®1- 


nfiAa/iK 


S n -.nd ll |e N °'|V v J. :modo - ' Caution: striking I- a second' time wj)l v'ntc' out "the 
page and lease I . so give the system time to react: 

■find mVi°' •' ll ' ,Chcd lirtCS , i " thcir ori S i,Kl1 Position. This is extremely aiseful if you ' 
« lines and 'you are not sure' where you got them." 

Kill the attached lines.. Note: «K /does not work. If one makes a practice of using the 

Kill the first 4 lines in. the, Attach buffer. (See ®-®C below.)’’ 

'omnia nds with llelat iu\ A rgument s (to add or retime lines lVom 'the end of the attach buffer) 

, .'Attach one more line to tiic end of the attach buffer. 

Attach three more lines to i.hc attach buffer. ' - . 

I Detach one lij^c Iroin tliejend'of the attach .buffer. - 

Copy oue more fine tiiid add it to the end of the.altadi buffer. ' 

I K'leto (kill) one line from the end of the attach 'buffer. 


0-I-® A . a 
®.1®A* 
®;C 

®C ~ ■ • 
®C 


® .1 | Xjlete ( k i 


) three lines. limn the end of the attach buffer. 



v - 1 

Vy ‘VT.- y]~ 
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. Section 7: Search and Substitution Commands 


(KIND) 2nd Substitution Commands 
page^or^ an^cnduTfil'c GCt '° f SCarcil and substitlllion commands that can be applied to a single 

use the. '®F. command, while multi-pagV .catches. use the extended command 
ln blUh cascs dic command is executed, starting with’ the A.RROW i ini; and extends either 
IchT 1 VT 1 Pa8 v ° r t0 mc cnd of thc n,e - VVhcn the’ current -arrow uni; has. been 

dhs eaiicr fonnd ™ 7 ^ " CW ™ Kh wi " bc S in J«* hc yond thc first character of 

d ’’ S ‘-* llCr /- nd occl, rrcncc of thc scarchcd-tor string. Multi-page searches may- be terminated at 

S,mhe? nf ,h C ^ tKat ' s / urrcnt| V being searched by giving thc .command <1501 (the pane 
number of thc last-searched page will be reported). ' p ° 

Two commands. ®tf®Xss. INRCR> and ®#®Xssrag.OTO are available to set the search limit 

SPCCifiCd linC W ^ — h^eiHly issued commands 

If the search is to be. for a delimited string a portion of text that is separated from die rest of 
arc *„ y s P accs ’ tabs -. <CR>s or ‘'thcr special characters), both die <(.OMROI > and the <mita> keys 
importimt Sn°c"!o,t ,C <C ° N " t0, > key ,s llscd whcn iniliaIin S a non-dclintitcd search. This is an. 

hnr C |h^ Ult f ° rm , °lv l: and ® Xr,Nn is to consider upper and lowercase letters to be equivalent .. 
(With , ® - 9x£SSS7ST H "distinction) 0 3 ^ ^ ^equent -arches 

Iherc arc several symbols tha 
shown in the following table. , 

searched- for string they must be preceded by the identity symbol = 


, . , , „ . mf have special meanings when used in the searched-for strin» is 

shown m the following table. \ ' If. these- characters arc desired as ordinary chanScrc ^'thc' 


Symbol 

V 


Meaning 

Any character may appear in this position. 

Any character except for the one that follows this symbol may appear. . 

Any delimiter (not a letter, number or S % or _ ) may appear. 

Treat (quote) die (normally spccial) symbol that foll/ws as an ordinary character. 

Not now used but must be quoted. ... 1 

hjot now used but v must he quoted. " * 


hna'ly.. the action to be taken on thc successful completion of the search mav be specified by the 

vS , ? ' S „ USCd ‘° ,Crmi " atC t ' , ° string. Commonly t.sed'delimEarc: <f'£ 

whK.1 calls for thc arrow to be move to the first line in which the scarched-loi\t,i»g’ is’ to be 
found and’ cKCio. which causes the l isi-i on mode to he entered with die ct rsor positioned 
n h u the first leltei of the^searched-lor string. Ollier delimiters are described in Section '7 1 below 

fi'ilurc is *” rcportcd!° l,,,suc ^ oss *' 1 • "«•«*«>" is “ken. die arrow . in,.; remains undisturbed and.tlie 

A few examples follow.' _ ; 

«l’Sniith<CR> I’ind the first .occurrence of die string SUI'V. «ir \miih or even ' smith ’-.in* 
• lihicksiHilli or in Simibsoiiitiii on the current paggj.s(,ntinc with the" ofescht arrow 
l INI’, and move the ARROW to’ lliis ri^ line. Therc^s.to bo no spUce! after the T 
since ill is is a single: let ter commahde.^-^.. . y ' 
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«X!- sitiith<CR> Same as above but searching from the arrow uni; to the end of the Gie.' Note 
the space alter the b . Also iiotc that currently there arc no other word commands 
starting with F, so only the F of llND.nccd be typed, but there must be a single 
space after die F in. -this cast? to ' signal the end "pf the word. 

aXF smitha<CR> As above but enter die line editor With the.CtJRSOR under the first letter of the 
. v searched- for string. 

or/JI smitlKC r> Find the delimited string smith. Ihis would not find smith in blacksmith or in 
Smitliiield. _ 

®9u/N'smiih<CR> Find the 9th occurrence of the string. If there are fewer than 9 occurrences' 
report the number and do not move, the ARROW. ‘-Note: asking for an impossibly 
large. nuiubei (such as ®oo) is a convenient to li.nc the occurrences counted.' 

7.1. • .Search-String Terminators * 

It -will lie possible to list hot a few of the -more important scarch-siring-terminating commands. 
Kemember. these terminators are to be used as a part of a search command. They have guile 
uil term meanings Mien typed separately. 

<CR> Move the arrow to the line.' found or report failure. • 

«sC R>>.' Move tiie arrow to the line found'.' enter the line editor and place the cursor under the 
first character of the searched -for string. 

Jump the line with tile searched- for string to the top of the Window. •> 

Attach all lines starting with the ARROW i f\i up to and including the line in which the 
searched- foV string is found. If this termination is used with die extended search command 
and if the string found is not on the in-core pagc(s). the attachment .will start at the 
beginning of the page containing the string. , 

IX'Icic all lines up to but not including .the line containing die scarclied-for string. This is a 
very dangerous command so use it with extreme caution. 

Make, the search over the directory page (Intt without mining the window to it) and then 
display the lefcrenced page With the : \RROW" pointing to the first line on this page. 
Make the scarch/ocer the directory page- Unit without mining the window to' it) and then 
uKpKi\ the ickMcnceJ'pituc with the \UROW pointing to -the* second occurrence on this p«ige 
of the searched- tor string '(the fust' being in the top line). ' 

® + ® It Just like ® I’ except that ihe.scarch starts w ith the nest page alter the current one. 

Make the, sc.ucli o'er the down ay .page and then' display the referenced pane with the 
arrow pointing to ‘the line containing tlie referenced m ring -as a label (see i-. ais for 
details). . . < 

l erminate searched- for string and prepare to accept a substitution string. See -section 7.3 

below. 

l ike ®\ for use on terminals 'without coniroi and mi- i a. keys. 

Aboil (be. present search command that is in process of being typed. 

7.2 . Kcpcating Search Coimilands 

Hi° ■i'xt-used search strings are remembered by F (that Is. they are' sticky). For a repeat, one can 
type the rest of the command including the desired termination (which may differ from the 
termination used the fust time), but omitting the string and (he previously defined string will be 
used.. I lie scaicli string lor a witilin-.i-p.ige search and the search string for an extended scare'll are 
remembered independejuly. 


a/m 

I* 

«/?P 


f 
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If several i<Jcntic:il substitutions .no. to bo made. it is usually wise 
. initially, using ihc-osi it v termination. and then to make tbo rest of tb 
command ®#<«/J\ altor elk-eking that tbo first desired sobstuution b. 
Ibis procedure is especially rcoommondod when substituting ;i null 
can be used as the, argument if substitutions are to bo made 

Sample commands are: . 

a/?l ; stringa«/?\Stringb« K> I'ind tbc first occurrence of stringa 
Stringb. where the indicated upper anti, lower cases in the s 

typed. Do. not leave the line in the ti\i- I'DITOR. Note: thi: 

termination but the substitution is not cancellable with 
«/}l''stringan/?\Stringb(i<c u> . As. above but lease the line in the l 
under the last character of tbo substituted string. I bis is slow 
but'lt lias the advantage that the' substit 
Use ibis command if you are not certain 
good practice always to make a sin-ale 
command, shown below, for other des 
.substitution has. ' in fact.- been made. 

KIM i vo/Ds I RIM ■l<i(/t.CO' , i !<s Find ail 
substitutions' of sikim.u '!..r sirimiv 
n\ Repeat the' previously -unde substitution 

leaving the 'line in the- \i foiior 
substituted string. Note the «\ rcip 
n/l\ Repeal the previously m.ule- suhstitutiou 


’Cstirrences of the string sikinoa and start, the 
at the '-’tli ' occurrence. , , 

at the ne\t occurrence of the searehed-for string, 
id*- the cursor under the last character of the 
res no other termination in this case. 

tit the next occurrence of the scarChcd'for string 
i diiOk. I his is faster than the rt\ command, 
'it lor the next (• iiccurrencos. One should always 
mmand which causes a lot of. useless entering and 
On the completion of the last substitution, the «<(.({> 
r un ok to be entered and the cursor to* be moved to the 
listitut-ion. if this is desired. 

mil till occurrences ol the searched- for siring have been 
pec i Tied m the original substitution), 
el'ied- In ..id substitution sitings. 
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8. Text Formatting Commands 

Text formatting commands in I-' arc given while in the xormai. 
apply to the spccificd’.nuinhcr of lines or. by default, either to an 
to a single line as will be noted later. Commands given in the ; 
contents of the attach, buffer. »• 


8.J Page Appending, Dividing and Combining Commands 
®Xappi : nixcr> 


Append the next page to the page (or pages) that are in core so that the two or 
more pages may . be viewed and cditcd^togathcr. The in-core nage mark 
will be represented on the screen b>> a line' of vertical ..bars. ‘ 

Split the current page into two pages with the arrow i ini: as the first line of 
the newly created, page and retain both pages in core without writing out 
anythin lire in-core page mark will appear as a line of vertical bars. ■ 
Spin the current page as above Inn write out the in-core pages. Retain in core 
only the new page, now starting at the ARROW 1.1S1:. If this command is.givcn 
m the a it ait l mode, the attached lines are first put down and then the page is 
divided. If the attachment is not at the top of a page the division is at the 
beginning of the lormcr attachment. If the attachment is a the top of the 
page, the division is at, the etui of the former attachment. In either case, the 
akrow is at the top line of the former attachment and only this -xrc is 
retained in core. 

Delete the page mark at the end of the last in-core page and add the text of 
the next page to the last in-core page, writing out the resulting text. 
When given with the ARROW pointing to- an in-cofc page mark, delete this 
page mark without writing out the resulting text 


/5<rojtM> 


®X\1ARK<CR> 


vyAiiKi-v p, oust. r> i treat: me ARROW t ini .(once) alter the 60th column (the initial default column 
is SO). A preceding numerical argument of one or larger will cause that many 
. es 10 1,0 hr,,kcn iis many times as necessary (see the next command). 

®4®Xhri:ak<cr> llroak -I lines starting with the arrow i.inivus many times as necessary so that 

, . ; . 110110 01 lllc resulting lines are longer than the default length. 

®4®Xjoin<c r> Join Hie 4 lines starting w ith the ARROW i ini; into one lint 1 ' by removing the 

, CRH's.. I he default argument Tor this command is '2 lines. 

8.3 l.ine filling ami Justifying Commands (for use with normal text) “< 

♦ * 

Only the simpler forms of these commands will be described in this manual. 1- actually provides a 
wide range ol commands lor justifying tost and tables. See the t.us manual, for details If the' 
text IS already broken ml*, paragraphs that are separated, by blank lines then the delimit options 
may be used. It is usually wise u. sine any recent corrections In dome a ®. belore usin° these 
commands so that one can undo their effect with the ®.\canci I <n<> command if necessary The' 
»M.M)I I ITI-«;r> command may also be used to undo the elV.vK of the,,. 


a numerical argument to define their range of action, 
lifer, they will apply to the attachment' 'only.' .The 
e range, as will he noted below. If the range is 
to the entire page or io the entire aitach but 
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Normally 4^Sh‘ Srf S'wiM'lhS? S?e S^* 11 ? ul f : ? uc " t r ri ; iin 8 and jusUfyins ^mmands. 

missing values that prcccdc thc vl^lS 0 -,^^ 1 ^ “f, must be. typed to indicate anj 
are 0.0,74,— ! (C,I.,R.H). • ■ yP • Hie initial default values for these margins 

for full details. ; ljrt margin specifying string. See i:.ai s 

s * . 

ialues PO from !n -core ' tST™ C °" miand - “ dCSCribcd bc,tw - causi "8 *"“> i« the margin 

<S,X)I " that^ieamun^ 'V^' thc " ,arpm Values bcforc executing the command. This is the Com 

®0® xm «> K> Ke f H' bU ‘ S ' ;,rlinS •" lhC b6ginni, ’ S ,,f lhc Paraph c«nu.iningv.he arrow. . 

sS ^a-Wjrs 

s i ' h! »** “* - < ~Z. ■ 

t? ^ 
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as required. In' contrast with the justifying commands, these commands default to operate on a 
single line '(the ARROW I .INI-:). A prefixed decimal argument or the use of the ATTACH buffer may 
be used to extend their range of. application. If the text contains interior tabs, these are converted 
to spaces before the move! so that- the absolute size, of the spacings arc preserved. An option exists, 
as demonstrated below, for changing the default condition so as to preserve interior tabs. When 
possible, initial ‘ tabs arc used to save disk storage space. A zero preceding argument will, cause the 
existing default values to be displayed.. 

®X.MICN<CR> Align the arrow i.ini-: (or the entire attach buffer), moving the line or lines 
^so that they start with the default align . indentation (originally, set to 0).. 
®8 ®Xamgn 3<CR> Align 8 lines starting with the ARROW i.ini- and indent them by 3 spaces. 

®8®Xai IGN T 3.<CR> As above, but preserve interior labs.: Note that the T argument is sticky. 

■ • fhc default condition can be restored by using the letter S. instead of T. 

©-» Move the ARROW I.INI-' to the right by the (absolute) default-indent value (initially at 4). 

©5@-» Move 5 lines starting with die ARROW t ini-: to the right- by the default amount. 
®*" Mode the ARROW I INI- to the. left by the (absolute) default value. The movement is 


8.5 Formatting Tabular Material 


Formatting tabular material is dificult if (1) the initial material is improperly aligned in columns or 
(2) if there arc missing entries.' K provides facilities for handling two distinct types of tabular 
material. In the first type, there can he no missing entries but the material need not be properly 
aliened into columns as long as the different’ entries are separated from each other by at 'least 2 
spaces or by tabs (and. of course, the entries themselves' must not contain double spaces or tabs), 
and the input material may contain some associated text (perhaps a comment field) that is to be 
justified or jfilled. In the second Type, the original material must be aligned in columns but there 
can be missing entries. 

Table-formatting commands require the spccificatimvbnrdclilional values beyond the C.I..R.15 values 
specified with the normal-tcxt-focmatting commands. When’ these arc typed they must start with a- 
semicolon and they, arc separated by commas. Values not otherwise marked are for field lengths, 
with the first field assumed to start at the I. eft margin, l-or example. :5.8.9<cr> means that the first 
field occupies 5 character positions, the second occupies 8 positions and the third occupies 9 
positions. For more details sec r.Ais. A command ®X Itil-Kcio, analogous to ®XJGlT<cit> is 


Foi details concerning the ©Xi aiii F<(R> command for material already aligned in columns and the 
©X I it s lffJ U^M4^©^2W.V-4C R> -commands for misaligned tabular material, see i-.ai.S. 



Section 9: Some At!ditionnV Command; 


wapu . I Jclctc 4 lines storting with the ARROW UNI*. 

©XCANCPL<CR> . Restore the in-core copy of the current page, from the disk, thus cancelling all 
changes made since .the last disk-save gommand. - 

©XUNDKI.I- ft-<CR> Restore to the beginning of the A1TAC1 1 buffer the last group of lines altered or 
^ deleted by a single command. Note that any lines changed by the last-executed line- 
■ changing command may be restored by this command. 

®#®XUNDrt t:rti<CR> Restore the last tt number of lines v/hether or not these were all 
altered or deleted by a single command. 

®0®XUNOi:i.i:n:<CR> Report the number of lines that arc available to undelete. 

Sec I-.ai!s(UP.IXX| for more details. 

9.2 Switching to a File Named oa the Page Being Fdited • 

©Xl’OINI t.R<c R> Switch to the first file named in the text being edited at or below the ARROW 

line. See I .At S[IJP.IXX'| for details as to how the file name must be formatted 

to be recognized by this- command. 

/' * ■ ' . ’ *■ > • 

93 Conserving Kile Space 

®XsiN<CR> Put spaces in place of tabs on the current page or die attach buffer. Ibis will, of 
course, increase the space occupied by th6 text but it may be necessary to preserve 
spacings if extra characters arc' to be added ahead of the tab*. 'Ibis command should 
be followed by the ®Xtin<cr> command’ and then, the ©Xburr<CR> command as 
soon as possible. j 

®Xtin<CR> Replace spaces by tabs where this will reduce the space occupied by the text. This 
command also deletes trailing spaces and lab's from all lines. Note that this extra space 
is all collected as all-null records at the end of.thc page and that the ®XnLRl’<CR>. 
command is still needed to save -Utis space, on the disk. " • ? 

®Xt)URP<CR> Write out the current page and in the process reduce the disk space for the page by •/ 
deleting any all-null records from the page. ' / 

®e/bo|-<CR> — Burp_i hc _ cn tirc_ciirtenti_Llle.. not just the current page. 

9.4 Generating a New Directory Line 

®Xndi aii.<cr> Generate a New Directory line for the Current page for a i-aii - or macro- type 
source file. - 

®XndsaII<CR> Generate a New Directory line for the current page for a SAit.-type source file. 

Ibis command can be modified for use with I’ascai. or any similiar language by 
replacing or adding to the list of category words that are used to signal the inclusion of 
the word that follows the category word. Some minor hand editing may he reouired 
See t:.Aisiui>.ixxj for details. • . 

9.5 Message and Paragraph Designating Commands > 

Ibe partial character 3on the Data Disc keyboard and the explanation point I. when used with @ 
refer to a message and. a paragraph, respectively*. A message is defined as a enbtiuuous set of lines 
(some of them may he Wank). which starts with a 3 and which is Ihlli. wed 'either bv u line 
beginning with another 3 or the end of the page. A paragr;>ph is Mmilnrh defined tis a edmi-uuus 
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set of nort-empty lines plus a single preceding empty line, if one exists, and all 'out one of any 
following empty lines .(actually all of the following empty lines if there arc no more non-blank lines 
on the page). • •- 

These two prefixes, by themselves, usually do not initiate any action but they do define the range of 
action of the command that follows. The one exception in which the 3 or ! initiates an action 
without waiting for a following command is when it is .preceded by a 0 argument (that' is ®0®3 
and ®0®!). For these eases the command immediately moves the arrow to the beginning of the 
current message or paragraph. • 

, I yping the 3 or ! with <(”0YIR0I> only, defines the message or paragraph as starting at the 
beginning of the current message or paragraph even if the arrow is not at the beginning. Typing 
the 3 or ! with both <C0NIR0I> and <\ti"i.\> defines the range of action as starting -at the ARROW’ 
i ini-: 


Some typical commands arc: 

' ' A " v 

Move the ARROW to the beginning of tlie current message. 

a3® A Attach the current message (at the’ end pi * die attaeh buffer ifthdre is -already something 

attached). . ' 

®~«3®A Attach the. previous message (at. the beginning of the attach buffer ahead of 
material that may already he attached). 

®J«3<»/JP Delete .1 message's beginning with the current one (stopping if. the last message on 
the page has been deleted). , • 

® -®co«3n/?P Delete all messages in the in-core pages that preceed the current one. 

® '(»/!<( it> Filter the- 1 ink inskrt inode between the current paragraph and the next one. 

«!®Xji.’SI«.’K> Justify ■ the anient paragraph. 

n/J!®.\ML’Sl<CR> Justify the rest ol the current paragraph starting with the arrow i ini:: 

9.6 Parenthesis; anti ’(racket Finding and Matching Commands 


infill commands . are: , 

Find the 'next left, symbol of cither the default variety or : 
® Xl’ARI-N command (see below), limiting the search to the 
ft RSOR is already at a loll symbol this command is a so til’. I I 
the ci RSOR is under a loll symbol, it refers to the condition just 
Similarly, when the ( t Rsott is under a right symbol, it. refers l< 



mMMHMj 


©4©( Move the cun so it to that left symbol that would , cause ^the nesting level to. reach 4, 
considering the present nesting level to be 0. Do not\ move the CURSOR .if this level is 
never reached. ,|- 

©4®Xlpari-n<cr> Similar to die above except that "the search is not limited to the in-core 
pagc(s). • V ” 

®) ,lf the CURSOR is under a left symbol, move the CURSOR to the matching right symbol if ir 
can be found on the in-core pagefs). If the CURSOR is' not 1 under a left symbol, then search 
for the right symbof that rcturncs the nesting, level to its current value. .Note that this 
command is a NO-OKonly when the desired level cannot be reached. If the end of the text 
is reached before a transition to-thc current level is found, the cursor is left in its original 
position and the deficiency is reported. Deficiencies may be of two sorts, either a left 
symbol is never reached, or a right symbol mi never have been encountered while at the 
next nesting level. 

®3®) As' above but search for the right symbol that reduces the lever from the specified nesting 
level, in this ease from level 3 to level 2 (considering the current level to' be 0). 

®3®Xrpari:n<cr> As above bat not limiting the search to the in-core pagc(s). 

03=* Undo the last parenthesis matching command and return the CURSOR to its former position. 
Iliis allows onp^fo look back and forth between the two matching symbols. 

®Xpari:n {<c:r> Define the parentheses to be the symbols { and }. Note that a single space 
m,ust separate the character from .parks and only die left symbol of the set need be typed, 
to -select a set from the following list of character pairs: ' / 

( ) — ' *• CD {}.<>[]. ' X V 

0XPAREX Az<CR> Define the parentheses to be "A" and "/" (any pair of characters may be used). 

A distinction is made between' upper and lower ease letters. Note that .bothjettefs must bo 
typed and that no. extra spaces- can be used (a space is a valid parertdiesisl). Obviously, the 
scheme will not work if the chosen 'diameters arc used for othcr,purposes in the text. 

®Xpinpo<CR> Type out information about die last parenthesis , search. 


9.7 l.isp Indenting Commands 




’• ha s limited ability to parse I ISP S-expressions and to indent lines accordingly (with tabs and 
spaces as needed). .Text is never moved from one line, to another. Super-brackets arc recognized, 
making J in the text close back to the matching [ of-close all hanging (*s if mi hanging [ is present 
to match, l-.xcept for this, diftcrence. -the parsing, is by Mad.isp character set interpretation using a 
uiblc of 128 entries that can be modified by,tlie ®Xl.lSPSVNTAX command (sec k.aiS for details) 

I he principal commands of interest are:' a 


a/ l isp indent the current line by context 'above it. 

aft/ l isp indent die next line by context above it or the first attached line in context of the 

Piige. y- 

at) a! l isp indent' tt lines starting with the arrow line. 

%tta\U I isp indent tt lines starting with the next line or with the first line in die attach buffer 
in context of the page. 

’ . • . . . 

9.8 Issuing System . Commands from K . 

*•? 

There are a number of system commands that Can the .issued while in H. Some of the more 
important commands of this type arc: 1 

®X,M l.\S <project>.<progr iiiiiiier><CR> Change alias Was In • die equivalent- sxgeni command. 
®XrRom riON<CR> Type out the protection key loKUie, file being edited. . ■ 
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©XPROTtcriOM nnn<CR> Change the protection for the' file being edited to' the octal value nnn. 

@XwRmi-'N<CR> Type' the date and time when the present, file was previously' written and 
^/the PPN and' jobnamc of the person who did it.. 

©Xmail {destination and switchcsXCR) Execute a system maii. command using- the text 
from the current page or -attach buffer. 

©O0XMAII. <destinationXspaccXonc line of textXCR) Execute a system maii. command limiting 
the message to the one line of text that is typed between a space following thc.dcstiiiberf 
and the terminating <cr>, that is with no text from’ die page or attach buffer. 

©Xsi-ND {destination and switchesXcR> Execute a system send command using the text 

from the current page or the attach buffer..- ; 

©OQXsiiM) {destination XspacqXonc line of tcxtXCR> Execute a system send command. limitin'? 
the message to, the one line of text that is typed between a space following the destination 
and the terminating .<CR>. 

.©Xremind {destination and switchesXcR) Execute a system remind command. 

©Xni INI) {tcxtXcR> Start a l ist) program as another job and report results. For detailed 
information on the MM) program see MNn.DONjijp.DOe).. 

©XspookcR) Spool the contents of the current page or of die attach buffer. 

©XxsPOOl <cr> XGP sp*x)l the contents of the current page or of the attach buffer. 
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> m Macra Conamands ■ ’ , . -•/ 

Mac^ avt provided in E to save the user the effort of retyping strings of commands that arc 
needed frequently. A Macro represents any number of characters that will be given to F. as 
commands and-text (in lieu of this material being retyped) whenever the Macro is called by name 
or by a simple repeat. command. A Macro may cal! other Macros or even itself (with nesting to a 
certain maximum depth), it may contain conditional branching and it may' be called with repeat 
arguments, n . agt. it is possible to write Macros that arc, in 'effect, complete- computer programs 
tnat , will make major modifications to die file being edited. 

All standard E commands (including UNE EDITOR, commands) may be used within Macros. There 
is one very important restriction: if a aD or <ri in a Macro is intended to be given at the end of a 
line. II must be' preceded by a «<TAB> or a ttK<CR>.- ' - ; ' . ... 

Macros may be defined and used during a single editing session and they may.be written into a 
command, file and saved for future use. Many, users find it convenient to develop a series of 
Macros that serve their particular, needs and to save. them in a file in their own disk area under the 
name of umi.cmd. I he contents of this file can then be loaded into the user's core area when 
needed during an editing session and they will then be available for, repeated use The file 


Most users of H.makc but little use of Macros. While the subject is much too complex for adco-Jatc 
coverage in the present manual, an attempt will, be made to show the value' of the Macro# and 
perhaps help new users to start using these commands. As a . start, the user is' urged to define a 
simple Macio, as explained in Section 9.1 below, and then to execute the Macro on a test program 
using the commands listed. in Section 9.2. Having done this, the next step might be to executed 
Macro-defining command from the file iimt.cmdIU). as explained in Section 9.3...,, 

10.1 Defining^ Macros Directly 1 

Macros may be defined with the command 

®Xdi:i ine <Macro name><CR>. 

S'hHnT '"; ,y . r COntain lcUcrs digits (with' only the first six characters being significant), it may 
be blank, or it can consist of exactly one of the following 9 characters: 

n U C D. $ % ~ V • 

winch appear on top of the digit keys on the DataDisc terminals'. On receipt of this command F 

wi I, ificuvrl 0 T ' COm,n f nds °"' d tcxt ? trin S s - * ‘>tiy> that the .Macro is to represent.' ending 
with afi<l M;>. he commands must be typed in exactly the name my that they m mid be t v Jd 
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.under .the name specified in accordance, with -.the above explanation. : ' 

,©6@Xdefine<cr> Type .out the names of all- defined Macros. , , 

©0©Z<Macro,nameXCR> Type out the named Macro wiUiout executing it ' 

®°® Y ■ /Type lout' the 1 Macro that would be executed by. the ©Y command as defined 
— ,in section 9.2 below. ; + ’ 

©Xstrr •<ncwrtamc^<oianamcXCR> ‘ Copy the definition of Macro oldname into the definition 
. of a new , Macro newname. • 

.®XSET <ncwname>.*-<CR> Copy the definition of.ia Macro that, was .typed with a blank -name 
into the definition : of a new Macro nev/narne.. » 

10.2 Calling Macros for Execution ' • ■ 

J : v . ■ . • . . • • - . 

Macros arc called for execution , by. one of th'c following commands. . 

®Z<Macro nameXCR> Execute the named Macro once. . 

®3®Z<macro.namcXCR> Kxccutc the named Macro .3 times. 

®C1 v, Execute the special’ single-character Macro named "h". ' ’ 

®8®CI Kxccutc the snccialsinclc-char.ictrr nim/vf "n- sa*... ' . 


®6®Y 


rp or the last defined 
too! co may be used for the number -of executions if the 
provisions for its termination. , 

10.3 -Executing Commands and Defining Macros - from a File • f 

- 4 . ■ • ,<• • • ■ ' . : 

Commands stored in a file may.be called for execution by the ©Xexf.clte command, as' described 
below It has becomc : common practice to write Macro files, as a scries of ®XDERNn<macro 
namcXcR> commands, each followed by the command list that is being defined and a ©Xsay 
< macr o nameXcR> command (this command simply causes the macro name to be typed out). 

hen such a file is called by the ©Xex'eclto command., it is the’ ©X define and ®Xsay 
.. commands that arc executed. Hie defined Macro or -.Macros arc simply defined (that is, loaded) 
into the users core area without being executed and the user is given the names of the Macros so 
oaded. The user may then cajl the individual Macros for subsequent execution.- as needed ush-> 
the commands- listed in section-' 9.2,) ® 

©XexfclTE <filc name> «piige fari g e>)<cR> ' Read the selected pages from the named fi!6 into a 
'•< • tc .™ P i ,r; ' ry M; ’f ro and thc - n execute .this Macro.- If no file name is given die default file 
will- be used (Initially EIMI CMD oh the users; tog-in area). If no page range is given, 
the. .entire file is- used. . & ° 

®0®Xi:xECLTl-<CR> . iype out the current default -execute file name.. 

10.4 Writing Maer6s into a CM!) File , .' , . . 

Ihc command' - ■ '7 > . ■ . . ", . . 

. v ®Xi>LT!5i:rs < file riamcXck> 

writes all of the Macro definitions that currently exist in the users core area into thc pamed file or 
mto.a default tile, it no name is given. This default file will' be the. last file - referenced by a 
®\I’UDH S<CR> or a ®\i \|( t.. |i:« -R> ctmmi.iinl. or if none lias been referenced it will be the file ' 
I JNIU-MD on the users_ log-in file area. If the Tile chosen. already exists, the newly stored Macros 
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• kI I f !C aS a ncw P 3 ^. If tlic file does not exist, one will bo' create?, the Mf-ros 
representation a's listed in the left column of the table in section 9.6- below 
Flcase note that, these representations arc nor lo be used when defining Macros with the XDiir-W 
command, although either of the two representations (or a mixture of the two) may .be used if one 
wntcs or edits a Macro' file for subsequent execution . as described below. 

10.5 Writing Macro Command Files Directly . '. V 

Most users prefer to write complicated Macros as one would write any normal computer program 
of course, using E as. the editor. Ihc alternate notation, as listed .in section 9.6, simplifies this'W’ 

3 2S f ° r USC f ° f P ata !i?, cd j a t 5 nninab - A Mscro filc *at is efeated in this way may contain 
a. directory page (which will : be ignored) and it mav« contain 


Betra spaces cannot- be inserted into the' command-file text for formatting as 
be part of the defined: Macro. Tabs in'the command-file text (as distinct f 
ignored, however, and . they may be used freely to separate commands or to s 
commands. Carnage returns and line feeds (nof'thc commands©?* etc.) alsc 
the . text to appear on multiple lines for legibility. 

-10.6 Notation used in CM1) files anti in Typing TlSm 
Representations 

Standard Alternate Command as accepted by E 

® = - ' ■ <TAB> -horizontal tab 

1 . ®A <ai.t> • • altmode 

® It ,®C • ^ . <CR> carriage return 

®1" ; <vt> vertical tab * 

®' 1 * . ©F • : <form> formfeed. 

®I- <LINK> linefeed • 

®* ® ^ . <BS> _ backspace 

® G . ®X ••in, a is wanted in the text , 

' ®Y " ' ' t.a p is wanted in the text 

®® < ®®„ a ® is wanted in the text > 

, ' ® : • 'snore text front hereto the end of the ling (for 

" WC Ignorctexi from hereto the next D (for long ci 

’ ° ®' Add<COMROI> biptpjicxt command 

P ®2 Add <MI-:i a> bit to the next command 

example: aF means the command <CON troi.>F 
while nr®!-' means the command <COVI uot xi'ORXDx 
and a®-» means tlK* command xrovritni viohvk’ 
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h is orten necessary to modily .Macros, either to correct them or to adapt them for use in a slightly 
different. s ' tuat ' on * l"his can be done by... using the following commands. 

®X attach <Macro name><CK>&. Put the named Macro into the attach buffer (which must be 
empty at the time this command is given). The. attachment may then Jac deposited in 
■ ' the current file for editing in the normal 'why. 

« • « „ . . > 

.®XRP.nriiNi: <Macro name><CR> Use the contents of the AiiTACi! buffer ’to redefine the named 
• Macro. • - 


*0.8 ^Terminating and Resuming Macro Expansion 

ITierc are several commands available to the user to 
these ..is important enough to be reported here.' F< 

GSOts 1 crmmatc'thc Macro expansion (either bee 
— \ you want to inspect what it is -doing). 

®Xri:sl'MT<cr> Resume the Macro 'expansion :nt 


10.9 Special. Macro .Commands 


A full , explanation, of the many special commands available for'usc in Macr 
ot the prescnl^jnanual. (t may be of interest, however, to list some of these 
have, some idea as to what, is available and will be better able to find w’antci 

I he .following commands arc used' to stop tripero expansion in the event of 
the; selective aborting of Macros that may have been called by other 
®XSI'OI>Al'.l.<CR> ®Xstoi>oni:<cr> ' ®Xst6r/i-roo 

With ®XSToi'iiow<CR> being available to request a report as to which of the thre 
: V- ■ 

The number-sign command in a Macro. ® // (where \ft .is actually, used 'in 
mean some specific number: as it is used elsewhere in this manual) allows- 
Macro to access and use*, the ‘repeat argument eiven with "ihe m:.™. , 


The following Commands niay bc.used 
macro name:. . • •• 

®XriT.T : . ' ®Xim-: ®Xiig 

®X.-\ni) . ® Xsi.iiTRAr r *• ®Xma: 

®XRi:M.viM)i-R ®X.\rglmi;nt ®0®Z. 


in macros and accept cither a read-only-variable name or a 


©XiiVq 
®Xyu tii.>i y 


®Xifni- ■ 
®Xnivint : 


available- all end with' a period and their names can not be abbreviated. 


• • w HMS' PACJI-' M’AGI-S. cot.. 

niARSpSfc -fORI IS , GORINS: ' CiORC'l IS. -ASCII, 
ft MAR.: HNL.M.. SI ISO Nt'OLNI) NSUHST 

.1 lie commands, ®.\S il l* <macroiiamc><CR>. ®&. and 
allow the user'to -step' through- the execution of a Maori 


COl-S. 

SIXBIT 


COI 1ST 
C.MAR. 


CHAR. 
I -MAR. 
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-■ J '-■ i 

■ o' > 
1 1 


<CTRI:> 

<CTRI> 


-■ 




■■ 


Get 


<(TRI.) 


<CHU.> 


<CI Kt > 


<CTR1> 


<CTRt> 


<\T> 


CCTRI.) 


<IORM> 


<CT RI > 


<CTRI > 


<CTRI.) 


<cirl> 


<CTIU > 


<CTRt.> 


<CI RI ) 


<CTRI.> 


<CTRI> 


<CTR1 > 


<cmi.> 


<CtRI.) 


<CIRl> 


<CIR|.> 


<CTRI > 


<CTRI.> 


V 

<AI.T> 

<HRI-AK> 


<ns> 

<n.l:AR> 

<psc> 


■ n ' ' ■ ' ■ '■ . . : 


■. * ..Appendix A 

Missing anti [Equivalent DatuMctlia Keys 


Most of the missing keys on the DataMcdia can he ’typed by holding the cm keC and tv pin* the 
character shown in. the loljowing table, three characters require the use of 2 separate kev stokes 
Caution: do not confuse the n, /i and ®. as shown iri lhis table, witli these svmbdls as emn’lovcd in 
this manual to 'mean the use: of control keys. ” 1 " 


Mold and Type then Type 


a • 

b ■ 

<Nl’t > 

d 


Appears Brightened 
4>n Screeh 
a' ' 


<CA!.i.> 


c 

. f 

s 

h 

k 

I 

n 

o 

P 

' q 

r 
s 
; t 
u 

V 

w 

X 

y ■ 
/.. 
\ 


(or t|. key only) 


<NC' 1 > 

<NU 1 > 

'<i:so 

<NUt> 

'<DI ; t> 

<MR> 

<NLI> 


<CI i:ar> 
<1 tot I» • 


-(minus sign) 



When entering a file, the user may request a numbers* of options as expressed by 
switches consist of a slash ( / ). then an optional decimal number, then a single let 
ot switches may follow the -file name: Should a conflict arise between switches 
overrides the earlier one. Only a few of die possible switches will be described 

kai s|u».noq. V 

/’C Create a new file with the specified name. This is equivalent to the use 
above. It can be used if one .discovers .that, the C in CKT was forgotten 
' finished typing the file name. It may also be needed when switchin 
. ‘ commands listed in section 3.1. 

/b Repagc and reformat the file, limiting the maximum number of lines 
default value of 33. Hxisting page, marks’ arc retained so some pages ma 
the specified value. Reformatting causes the file to be rewritten on the di: 
saving in space by removing unnecessary null records at’ die end t 
/66b Repage and reformat the tile, limiting the maximum page si/e to 
/oof I he infinity sign mav be used as a numhor This a.. 
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